---
title: "Setting Up Slack OAuth App"
description: "Complete guide to creating and configuring a Slack OAuth application"
---

## Prerequisites

- Slack Account

## Step 1: Create Slack Developer Account & App

1. Visit [https://api.slack.com/apps](https://api.slack.com/apps)
2. On the **Your Apps** page, select **Create New App**.
3. Select **From Scratch**.
4. Enter your **App Name**.
5. Select the **Workspace** where you'll be developing your app. You'll be able to distribute your app to other workspaces later if you choose.
6. Select **Create App**.

<img src="/images/knowledge-base/slack_oauth_app/step1_AppCreation.png" alt="Slack App Creation Form" />

## Step 2: Configure OAuth Settings

1. Go to the **"OAuth & Permissions"** tab in your application dashboard
2. Add redirect URLs: `https://api.klavis.ai/oauth/slack/callback`
3. Click **"Save URLs"**

Here is an example of Klavis AI OAuth app configuration:

<img src="/images/knowledge-base/slack_oauth_app/step2_redirect.png" alt="OAuth Settings Configuration" />

## Step 3: Request Scopes

<Note>
Klavis Slack MCP Server uses the following OAuth scopes:

    **Bot Scopes:** `app_mentions:read, channels:join, chat:write, im:history, reactions:read, reactions:write`

    **User Scopes:** `channels:history, channels:read, channels:write.invites, chat:write, groups:history, groups:read, groups:write.invites, im:history, im:read, im:write, mpim:history, mpim:read, mpim:write, search:read, users:read`
</Note>

1. Go to the **"OAuth & Permissions"** tab in your application dashboard.
2. Scroll Down to **"Scopes"**, and add scopes

<img src="/images/knowledge-base/slack_oauth_app/step3_scopes.png" alt="Scopes Settings Configuration" />
<Check>
You have successfully created a Slack OAuth application! You now have your Client ID and Client Secret ready for integration with Klavis AI.
</Check>

## Step 4: Configure App Distribution

1. Go to the **"Manage Distribution"** tab in your application dashboard
2. Configure your app's public distribution settings as needed

<img src="/images/knowledge-base/slack_oauth_app/step4_distribution.png" alt="Slack App Distribution Settings" />

## (Optional) Step 5: White Labeling

<Note>
White labeling allows you to customize the OAuth experience with your own branding instead of Klavis AI's.
</Note>

If you want to use your own Slack OAuth application with custom branding:

1. **Configure White Labeling**: Go to [https://www.klavis.ai/home/white-label](https://www.klavis.ai/home/white-label)
2. **Add Your Credentials**: Enter your Slack **Client ID** and **Client Secret**.
3. **Set Redirect URI**: Use `https://api.klavis.ai/oauth/slack/callback` or your custom callback URL
4. **Initiate OAuth**: Use your client ID when starting the OAuth flow:
   ```javascript
   const authUrl = `https://api.klavis.ai/oauth/slack/authorize?instance_id=${instanceId}&client_id=${yourClientId}`;
   ```

<Tip>
For detailed white labeling implementation and code examples, see our [OAuth & White Labeling guide](/auth/white-label).
</Tip>

## Resources
- [Slack Quickstart](https://api.slack.com/quickstart)
- [Klavis OAuth & White Labeling Guide](/auth/white-label)
- [Klavis White Label Dashboard](https://www.klavis.ai/home/white-label)